This page last changed on Dec 17, 2009 by ggaskell.

The Spaces List Macro is used to display a list of spaces from within a page.

By default, Confluence lists the spaces from your current view of spaces on the Dashboard.

For each space listed, there is a link to browse the space, and to add a new page (if the user has permission to create pages).

On this page:

Usage with the Macro Browser

To insert the spaces list macro into a page using the Macro Browser,

  1. Open your desired Confluence page or blog post, then click the 'Edit' button. The page or blog post opens in edit mode.
  2. Click the Macro Browser icon on the toolbar. The macro browser window opens in the middle of the screen in 'macro selection' mode.
  3. Scroll through the list of macros. Alternatively, start typing part of the name of your desired macro into the search box at the top right of the macro browser window. Macros with a matching name will appear in the main pane.
  4. Click on the desired macro to access its parameters and preview parameter changes ('preview mode').
  5. Set the macro parameters to your requirements. If desired, you can preview these changes by clicking 'Refresh'.
  6. Click 'Insert' to put the macro into the page.

You can also insert macros via autocomplete. For more information, see Using Autocomplete in the Rich Text Editor.


Once you've found the spaces list macro, click 'insert' to add it to your page.

Usage with the Wiki Markup Editor

What you need to type What you will get
{spaces-list}

Space: Application Links 1.x
Documentation for AppLinks version 1.x
Space: Application Links 2.0
Documentation for AppLinks 2.0
Space: Application Links 2.1
Documentation for AppLinks 2.1
Space: Application Links 3.0
Documentation for the latest version of AppLinks.
Space: AtlasCamp 2010
Space: Atlassian Customer Resources
Browse the "CUST" space You dont have permission to add pages to "{0}" Add "CUST" to your favourites
Space: Atlassian Developer Network
For the community of developers modifying and extending JIRA & Confluence.
Space: Atlassian Development
Atlassian Developers. Because they're just too good to be kept hidden in an office in Sydney.
Browse the "DEV" space You dont have permission to add pages to "{0}" Add "DEV" to your favourites
Space: Atlassian Documentation
Information about and links to the Atlassian product documentation, including downloadable documentation
Space: Atlassian Events
Space: Atlassian IDE Connectors
Documentation for the Atlassian Connectors for Eclipse and IntelliJ IDEA
Space: Atlassian Integration Guide
The ways your Atlassian applications work together and how you can make it happen
Space: Atlassian KnowledgeBase
Browse the "KB" space You dont have permission to add pages to "{0}" Add "KB" to your favourites
Space: Atlassian Partner Wiki
Browse the "APW" space You dont have permission to add pages to "{0}" Add "APW" to your favourites
Space: Atlassian Presentations
Browse the "ATLP" space You dont have permission to add pages to "{0}" Add "ATLP" to your favourites
Space: Atlassian Training
Space: Atlassian t-shirt Competition
Space: Atlassian User Group
Space: Atlassian User Interface (AUI)
Browse the "AUI" space You dont have permission to add pages to "{0}" Add "AUI" to your favourites
Space: Atlassian Webinars
Space: Bamboo 1.0
Documentation for Bamboo 1.0
Space: Bamboo 1.1
Documentation for Bamboo 1.1
Space: Bamboo 1.2
Documentation for Bamboo 1.2
Space: Bamboo 2.0
Documentation for Bamboo 2.0
Space: Bamboo 2.1
Documentation for Bamboo 2.1
Space: Bamboo 2.2
Documentation for Bamboo 2.2
Space: Bamboo 2.3
Documentation for Bamboo 2.3
Space: Bamboo 2.4
Documentation for Bamboo 2.4
Space: Bamboo 2.5
Documentation for Bamboo 2.5
Space: Bamboo 2.6
Documentation for the latest version of Bamboo
Space: Bamboo Extensions
Space: Bamboo Knowledge Base
Troubleshooting and support tips for Bamboo
Space: Bitbucket
Documentation for Atlassian Bitbucket
Space: Bitbucket Development
API and developer documentation for Bitbucket.
Space: Bitbucket Knowledge Base
Troubleshooting and support tips for Bitbucket
Browse the "BBKB" space You dont have permission to add pages to "{0}" Add "BBKB" to your favourites
Space: Clover 2.0
Documentation for Clover 2.0
Space: Clover 2.1
Documentation for Clover 2.1
Space: Clover 2.3
Documentation for Clover 2.3
Space: Clover 2.4
Documentation for Clover 2.4
Space: Clover 2.5
Documentation for Clover 2.5
Space: Clover 2.6
Documentation for Clover 2.6
Space: Clover 3.0
Documentation for the latest version of Clover
Space: Clover Knowledge Base
Troubleshooting and support tips for Clover
Space: Codegeist
Atlassian's Codegeist! :)
Space: Confluence 1.4 User Guide
User Guide for Confluence 1.4
Space: Confluence 2.0
User Guide for Confluence version 2
Space: Confluence 2.10
Complete documentation for Confluence version 2.10
Space: Confluence 2.5
Complete documentation for Confluence versions 2.0 to 2.5.3.
Space: Confluence 2.5.6
Complete documentation for Confluence versions 2.5.4 to 2.5.8.
Space: Confluence 2.6
Complete documentation for Confluence version 2.6
Space: Confluence 2.7
Complete documentation for Confluence version 2.7
Space: Confluence 2.8
Complete documentation for Confluence version 2.8
Space: Confluence 2.9
Complete documentation for Confluence version 2.9
Space: Confluence 3.0
Complete documentation for Confluence version 3.0
Space: Confluence 3.1
Complete documentation for Confluence version 3.1
Space: Confluence 3.2
Complete documentation for Confluence version 3.2
Space: Confluence 3.3
Complete documentation for Confluence version 3.3
Space: Confluence 3.4
Documentation for the latest version of the Confluence wiki: Installation Guide, User Guide, Admin Guide and other techn...
Browse the "DOC" space You dont have permission to add pages to "{0}" Add "DOC" to your favourites
Space: Confluence Development
Space: Confluence Evaluator Resources
Space: Confluence Extensions
Space: Confluence Homepage Image
Space: Confluence Hosted Evaluator Resources
Space: Confluence Knowledge Base
Troubleshooting and support tips for Confluence
Space: Confluence SharePoint Connector 1.0
Documentation for version 1.0.x of the Confluence SharePoint Connector.
Space: Confluence SharePoint Connector 1.1
Documentation for version 1.1.x of the Confluence SharePoint Connector.
Space: Confluence SharePoint Connector 1.2
Documentation for the Confluence SharePoint Connector 1.2. This product integrates Confluence with Microsoft SharePoint.
Space: Confluence User Community
This space is for discussing ideas, new features and suggestions for Confluence.
Space: Crowd 1.0
Documentation for Crowd version 1.0.x
Space: Crowd 1.1
Documentation for Crowd version 1.1.x
Space: Crowd 1.2
Documentation for Crowd version 1.2.x
Space: Crowd 1.3
Documentation for Crowd version 1.3.x
Space: Crowd 1.4
Documentation for Crowd version 1.4.x
Space: Crowd 1.5
Documentation for Crowd version 1.5.x
Space: Crowd 1.6
Documentation for Crowd version 1.6.x
Space: Crowd 2.0
Documentation for the latest version of Crowd single signon and identity management
Space: Crowd Development
Space: Crowd Extension
Space: Crowd Knowledge Base
Troubleshooting and support tips for Crowd
Space: Crucible 1.1
Documentation for Crucible 1.1
Space: Crucible 1.2
Documentation for Crucible 1.2
Space: Crucible 1.5
Documentation for Crucible 1.5
Space: Crucible 1.6
Documentation for Crucible 1.6
Space: Crucible 2.0
Documentation for Crucible 2.0
Space: Crucible 2.1
Documentation for Crucible 2.1
Space: Crucible 2.2
Documentation for Crucible 2.2
Space: Crucible 2.3
Latest documentation for Crucible: do your code reviews, your way
Space: Crucible Knowledge Base
Troubleshooting and support tips for Crucible
Space: Demonstration Space
A space which demonstrates Confluence functionality.
Browse the "ds" space You dont have permission to add pages to "{0}" Add "ds" to your favourites
Space: Doc Sprint
Space: Documentation for the Universal Plugin Manager 1.0
Documentation for the Universal Plugin Manager 1.0
Space: Enterprise Hosting
Documentation and resources for Enterprise Hosted versions of Confluence and JIRA
Space: Evaluator Resources
Space: FishEye 1.3
Documentation for FishEye 1.3
Space: FishEye 1.4
Documentation for FishEye 1.4
Space: FishEye 1.5
Documentation for FishEye 1.5
Space: FishEye 1.6
Documentation for FishEye 1.6
Space: FishEye 2.0
Documentation for FishEye 2.0
Space: FishEye 2.1
Documentation for FishEye 2.1
Space: FishEye 2.2
Documentation for FishEye 2.2
Space: FishEye 2.3
Latest documentation for FishEye, your view into your source code repository
Space: FishEye and Crucible Development
Tutorials and reference for enhancing and integrating FishEye and Crucible
Space: Fisheye Knowledge Base
Troubleshooting and support tips for Fisheye
Space: Gadget Development
Space: Gadgets and Dashboards 1.0
Documentation for version 1.0.x of Atlassian Gadgets and Dashboards
Space: Gadgets and Dashboards 2.0
Documentation for the latest version of Atlassian Gadgets and Dashboards
Space: GreenHopper 3.8
Documentation archive for GreenHopper 3.8
Space: GreenHopper 4.0
Documentation for GreenHopper 4.0
Space: GreenHopper 4.1
Documentation for GreenHopper 4.1
Space: GreenHopper 4.2
Documentation for GreenHopper 4.2.
Space: GreenHopper 4.3
Documentation for GreenHopper 4.3
Space: GreenHopper 4.4
Documentation for GreenHopper 4.4
Space: GreenHopper 5.0
Documentation for GreenHopper 5.0
Space: GreenHopper 5.1
Documentation for GreenHopper 5.1
Space: GreenHopper 5.2
Documentation for the latest version of GreenHopper.
Browse the "GH" space You dont have permission to add pages to "{0}" Add "GH" to your favourites
Space: GreenHopper 5.2 Documentation Archive
Documentation for the latest version of GreenHopper.
Space: GreenHopper Knowledge Base
Browse the "GHKB" space You dont have permission to add pages to "{0}" Add "GHKB" to your favourites
Space: JIRA 3.x Developer Documentation Archive
JIRA 3.x developer documentation archive
Space: JIRA 4.0
Documentation for JIRA 4.0
Space: JIRA 4.1
Documentation for JIRA 4.1
Space: JIRA 4.2 Beta
Documentation for the latest version of JIRA.
Browse the "JIRA" space You dont have permission to add pages to "{0}" Add "JIRA" to your favourites
Space: JIRA Community Space
Space: JIRA Download Evaluator Resources
Space: JIRA Extensions
Space: JIRA Hosted Evaluator Resources
Space: JIRA Knowledge Base
Troubleshooting and support tips for Jira
Space: JIRA Studio
Documentation for the current version of JIRA Studio.
Space: JIRA Studio Evaluator Resources
Space: Partner Program
Space: Plugin Framework
Documentation for all versions of the Atlassian Plugin Framework.
Space: Plugin Framework 2.0
Documentation for version 2.0 of the Atlassian Plugin Framework.
Space: Plugin Framework 2.1
Documentation for version 2.1 of the Atlassian Plugin Framework.
Space: Plugin Framework 2.2
Documentation for version 2.2 of the Atlassian Plugin Framework.
Space: Plugin Framework 2.3
Documentation for version 2.3 of the Atlassian Plugin Framework.
Space: REST APIs
Space: Shared Access Layer
Documentation for the Atlassian Shared Access Layer (SAL)
Browse the "SAL" space You dont have permission to add pages to "{0}" Add "SAL" to your favourites
Space: Support
Atlassian's legendary support team's projects and policy.
Space: Test space
Space: The Confluence Test Space
This is a space dedicated to testing and playing around with Confluence features. Everyone is invited to experiment.
Space: Universal Plugin Manager 1.2
Documentation for the Universal Plugin Manager 1.2
Browse the "UPM" space You dont have permission to add pages to "{0}" Add "UPM" to your favourites
Space: Universities
Browse the "UNI" space You dont have permission to add pages to "{0}" Add "UNI" to your favourites
Space: User Group Sponsorship
Browse the "UGS" space You dont have permission to add pages to "{0}" Add "UGS" to your favourites

Parameters

Parameters are options that you can include in Confluence macros to control the content or format of the macro output. The table below lists relevant parameters for this macro.

Parameter names are different in the macro browser and in wiki markup. Below we show the macro browser parameter names in bold text, and the equivalent wiki markup parameters in (bracketed) text. If we do not show any parameter name for the wiki markup, then you should leave out the parameter name and simply include the parameter value as the first parameter, immediately after the colon (:).

Parameter Required? Default Description
Scope of spaces no all Specify the view from which spaces are listed. Available options are:
  • all — all spaces in the Confluence installation.
  • team — spaces grouped according to team labels.
  • my — spaces which you have added to your favourites list.
  • new — new spaces which have been created within the last 7 days.
Width of List
(width)
no 100% Specify the width of the table. The width of the spaces list table, specified as a percentage (%).

Examples

Specify the width of the table in which the spaces are listed

{spaces-list:width=40%}

Specify the view from which spaces are listed

{spaces-list:team}

Replace 'team' with 'all', 'my' or 'new' to display all spaces, my spaces only or new spaces only.

RELATED TOPICS

Browsing a space
Creating a New Page
Working with Macros

Take me back to the Confluence User's Guide.

Document generated by Confluence on Oct 12, 2010 20:43